Step 1. Determine storage node addresses

Determine the IP addresses of the machines on which storage nodes will be running.

Step 2. Determine cluster configuration settings

Some storage node settings are shared cluster-wide and must be the same for each node. The following properties (that can appear in rhq-storage.properties) are cluster-wide settings:

If you specify any of these in a rhq-storage.properties file with --storage-config, then the values must be the same for each storage node.

Step 3. Install first storage node

Use the --storage-config option to specify the seeds property along with any other custom configuration for the storage node. The seeds property should look like,

seeds=address-1,address-2,address-3

where address-1, address-2, and address-3 refer to the IP addresses of storage node's 1 through 3 respectively.

Now install the storage node.

$ rhqctl install --storage --storage-config=rhq-storage.properties

This will install the storage node and the agent but not the server.

Step 4. Install second storage node

Just like we did for the first storage node, create a rhq-storage.properties file that includes a seeds property along with any other custom configuration

seeds=address-1,address-2,address-3

Now install the storage node.

$ rhqctl install --storage --storage-config=rhq-storage.properties

Step 5. Install third storage node

Just like we did for the first and second storage nodes, create a rhq-storage.properties file that includes a seeds property along with any other custom configuration

seeds=address-1,address-2,address-3

Now install the storage node.

$ rhqctl install --storage --storage-config=rhq-storage.properties

Step 6. Configure the Server for Installation

On the machine where you will install the RHQ Server, you will have to update <rhq-install-dir>/bin/rhq-server.properties with connection information for the storage nodes. You need to edit the rhq.cassandra.seeds property which should look like,

# A comma-delimited list of seed nodes. Each Cassandra node uses this list as
# contact points to find other nodes in the cluster and learn the ring
# topology. The RHQ server(s) use this list to connect to the cluster;
# therefore, this property MUST BE SET in order for RHQ to talk to Cassandra.
# Each entry in the list consists of three fields that are pipe-delimited. The
# of an entry is as follows,
#
#    hostname|jmxPort|nativeTransportPort|
#
rhq.cassandra.seeds=address-1|7299|9142,address-2|7299|9142,address-3|7299|9142

Note that the example uses default values for the jmxPort and nativeTransportPort connection properties (7299 and 9142 respectively). If you specified non-default values with the --storage-config option, be sure to substitute the correct values that you have set in your storage configuration file.

After you finish configuring the server for installation, install with

$ rhqctl install --server --agent

This will install the server and the agent but no storage node.

Step 1. Determine storage node address

Determine the IP address of the machine on which storage node will be running.

Step 2. Determine cluster configuration settings

If you used any non-defaults for cluster-wide properties with the first storage node, make certain that the second storage node has the same values.

Step 3. Install the storage node

Use the --storage-config option to specify the seeds property along with any other custom configuration for the storage node. The seeds property should look like,

seeds=address-1

where address-1 is the IP address of the initial storage node that is already installed

Now install the storage node.

$ rhqctl install --storage --storage-config=rhq-storage.properties

And you are done. There is no need to apply configuration changes to the first storage node or the server. The necessary changes will be applied automatically when the new storage node is auto-imported into inventory.